home *** CD-ROM | disk | FTP | other *** search
/ Just Call Me Internet / Just Call Me Internet.iso / prog / atari / m2 / cat3src / magic / d / mthelp.d < prev    next >
Text File  |  1997-10-26  |  8KB  |  123 lines
  1. (*----------------------------------------------------------------------*
  2.  *                                                                      *
  3.  *  MAGICTOOLS   Modula's  All purpose  GEM  Interface  Cadre  Toolbox  *
  4.  *               ÿ         ÿ            ÿ    ÿ          ÿ               *
  5.  *----------------------------------------------------------------------*
  6.  * Version 3.30  02.02.1992     (C)90/91/92 by Peter Hellinger Software *
  7.  *----------------------------------------------------------------------*
  8.  *            Dieses Modul ist urheberrechtlich geschtzt.              *
  9.  *                                                                      *
  10.  * Die Ver”ffentlichung des Quelltextes oder Teilen daraus, sowie die   *
  11.  * Verbreitung des bersetzten, nicht gelinkten Codes in schriftlicher, *
  12.  * oder maschinenlesbarer Form, insbesondere in Zeitschriften, Mail-    *
  13.  * boxen oder anderen Medien bedarf der ausdrcklichen schriftlichen    *
  14.  * Einverst„ndnisserkl„rung des Autors.                                 *
  15.  *                                                                      *
  16.  * Die Verbreitung des Moduls als Teil eines gelinkten Programms ist    *
  17.  * fr Lizenznehmer ausdrcklich erlaubt!  Der Autor beh„lt sich das    *
  18.  * Recht vor, diese Erlaubnis jederzeit und ohne Angaben von Grnden zu *
  19.  * widerrufen.                                                          *
  20.  *----------------------------------------------------------------------*)
  21.  
  22. (*----------------------------------------------------------------------*
  23.  * mtHelp       Einfaches Hilfsystem                                    *
  24.  *                                                                      *
  25.  * Die eigentlichen Hilfstexte stehen in einem ASCII-Textfile, welches  *
  26.  * speziell formatierten Text enth„lt. Dabei k”nnen dem Hilfssystem     *
  27.  * durch den Text Kommandos gegeben werden.                             *
  28.  *                                                                      *
  29.  * Das Format des Hilftextes:                                           *
  30.  *                                                                      *
  31.  * KOORDINATEN  Hier erwartet das Modul 4 Zahlen, die die Gr”že des     *
  32.  *              Hilfs-Bildschirms definieren. Die ersten beiden Zahlen  *
  33.  *              sind die X- und Y-Koordinate in Pixel, die n„chsten     *
  34.  *              beiden Breite und H”he in Spalten und Zeilen.           *
  35.  *                                                                      *
  36.  * Die eigentliche Hilfe besteht aus Textgruppen von folgendem Aufbau:  *
  37.  *                                                                      *
  38.  * @TITEL                                                               *
  39.  * TEXT                                                                 *
  40.  * @                                                                    *
  41.  * NEXTHELP                                                             *
  42.  * @                                                                    *
  43.  *                                                                      *
  44.  * Der Hilfstext kann beliebig viele dieser Gruppen enthalten.          *
  45.  * Die Einzelnen Eintr„ge bedeuten:                                     *
  46.  *                                                                      *
  47.  * @TITEL     Das ist die Kennung des Hilftextes. Sie wird eingeleitet  *
  48.  *            durch ein '@' im ersten Zeichen der Zeile.  Anhand dieser *
  49.  *            Kennung sucht das Modul nach dem Hilfstext.               *
  50.  *                                                                      *
  51.  * TEXT       Hier folgt nun der eigentliche Hilfstext, der im Fenster  *
  52.  *            ausgegeben wird. Abgeschlossen wird der Hilfstext durch   *
  53.  *            ein '@' in erster Position einer Zeile.                   *
  54.  *            Innerhalb des Hilftextes sind Steuerzeichen m”glich:      *
  55.  *                                                                      *
  56.  *              %U Unterstreichen EIN bzw. AUS                          *
  57.  *              %F Fett EIN bzw. AUS                                    *
  58.  *              %I Kursiv EIN bzw. AUS                                  *
  59.  *              %H Inverse Schrift EIN bzw. AUS                         *
  60.  *              %L Helle Schrift EIN bzw. AUS                           *
  61.  *              %S Hochgestellte Schrift                                *
  62.  *              %T Tiefgestellte Schrift                                *
  63.  *              %C Hilfsfenster l”schen                                 *
  64.  *              %K Gibt ein Popup mit einem Weiter/Beenden-Text aus     *
  65.  *              %% Prozentzeichen ausgeben                              *
  66.  *                                                                      *
  67.  * NEXTHELP   Hier folgt eine Liste von weiteren Hilfstiteln, wie unter *
  68.  *            @TITEL beschrieben, jedoch OHNE FšHRENDES '@'. Aus diesen *
  69.  *            Titeln wird ein Popupmen generiert, aus welchem der      *
  70.  *            Benutzer weitere Hilfstitel aufrufen kann. Es sind je     *
  71.  *            Hilfstext bis zu 20 weiterfhrende Titel erlaubt. Abge-   *
  72.  *            schlossen wird die Liste wieder mit einem separaten '@'.  *
  73.  *                                                                      *
  74.  * Hier ein Beispiel-Hilfstext:                                         *
  75.  *                                                                      *
  76.  * 100 100 300 150                                                      *
  77.  * @HELP                                                                *
  78.  *  %UHilfe 1%U                                                         *
  79.  *  Das ist der Hilfsbildschirm No. 1                                   *
  80.  *  Das ist der Hilfsbildschirm No. 1                                   *
  81.  *  Das ist der Hilfsbildschirm No. 1                                   *
  82.  *                                                                      *
  83.  *  Bitte Taste drcken!%T                                              *
  84.  *  Das ist der Hilfsbildschirm No. 1                                   *
  85.  *  Das ist der Hilfsbildschirm No. 1                                   *
  86.  *  Das ist der Hilfsbildschirm No. 1                                   *
  87.  *  Das ist der Hilfsbildschirm No. 1                                   *
  88.  * @                                                                    *
  89.  * Hilfe No.2                                                           *
  90.  * Hilfe No.3                                                           *
  91.  * @Hilfe No.2                                                          *
  92.  *  %F%UHilfe No.2%U%F                                                  *
  93.  *  Das ist der Hilfsbildschirm No. 2                                   *
  94.  *  Das ist der Hilfsbildschirm No. 2                                   *
  95.  *  Das ist der Hilfsbildschirm No. 2                                   *
  96.  *  Das ist der Hilfsbildschirm No. 2                                   *
  97.  * @                                                                    *
  98.  * @Hilfe No.3                                                          *
  99.  *  %KHilfe No.3%K                                                      *
  100.  *  Das ist der Hilfsbildschirm No. 3                                   *
  101.  *  Das ist der Hilfsbildschirm No. 3                                   *
  102.  *  Das ist der Hilfsbildschirm No. 3                                   *
  103.  *  Das ist der Hilfsbildschirm No. 3                                   *
  104.  * @                                                                    *
  105.  * @                                                                    *
  106.  *                                                                      *
  107.  *----------------------------------------------------------------------*)
  108.  
  109. DEFINITION MODULE mtHelp;
  110.  
  111. PROCEDURE Help (filename, selstring: ARRAY OF CHAR);
  112. (* Dies ist die zentrale Hilfsprozedur. filename ist der Dateiname des
  113.  * Hilfstextes. Die Prozedur sucht mittels ShelFind auf den Standard-
  114.  * pfaden des OS. Mit selstring wird der zu suchende Hilfstext-Titel
  115.  * angegeben. Bitte das fhrende '@' nicht vergessen!
  116.  *
  117.  * Beispiel:  Help ('TEXT.HLP', '@HELP');
  118.  *
  119.  *)
  120.  
  121. END mtHelp.
  122.  
  123.